package com.ruoyi.system.service;

import java.util.List;
import com.ruoyi.system.domain.StudentInfo;

/**
 * 学生信息Service接口
 *
 * @author ltr
 * @date 2024-10-21
 */
public interface IStudentInfoService
{
    /**
     * 查询学生信息
     *
     * @param studentId 学生信息主键
     * @return 学生信息
     */
    public StudentInfo selectStudentInfoByStudentId(Long studentId);

    /**
     * 根据用户ID查询学生信息
     *
     * @param userId 用户ID
     * @return 学生信息
     */
    public StudentInfo selectStudentInfoByUserId(Long userId);

    /**
     * 查询学生信息列表
     *
     * @param studentInfo 学生信息
     * @return 学生信息集合
     */
    public List<StudentInfo> selectStudentInfoList(StudentInfo studentInfo);

    /**
     * 新增学生信息
     *
     * @param studentInfo 学生信息
     * @return 结果
     */
    public int insertStudentInfo(StudentInfo studentInfo);

    /**
     * 修改学生信息
     *
     * @param studentInfo 学生信息
     * @return 结果
     */
    public int updateStudentInfo(StudentInfo studentInfo);

    /**
     * 批量删除学生信息
     *
     * @param studentIds 需要删除的学生信息主键集合
     * @return 结果
     */
    public int deleteStudentInfoByStudentIds(Long[] studentIds);

    /**
     * 删除学生信息信息
     *
     * @param studentId 学生信息主键
     * @return 结果
     */
    public int deleteStudentInfoByStudentId(Long studentId);

    /**
     * 保存或更新学生信息（如果存在则更新，不存在则插入）
     *
     * @param studentInfo 学生信息
     * @return 结果
     */
    public int saveOrUpdateStudentInfo(StudentInfo studentInfo);

    // ==================== 新增：管理员功能 ====================

    /**
     * 新增学生信息并自动创建系统账号
     *
     * @param studentInfo 学生信息
     * @return 结果
     */
    public int insertStudentInfoWithAccount(StudentInfo studentInfo);

    /**
     * 校验学号是否唯一
     *
     * @param studentInfo 学生信息
     * @return 结果
     */
    public boolean checkStudentNoUnique(StudentInfo studentInfo);

    /**
     * 导入学生信息数据
     *
     * @param studentList 学生信息数据列表
     * @param isUpdateSupport 是否更新支持，如果已存在，则进行更新数据
     * @param operName 操作用户
     * @return 结果
     */
    public String importStudentInfo(List<StudentInfo> studentList, Boolean isUpdateSupport, String operName);

    /**
     * 重置学生账号密码
     *
     * @param studentId 学生ID
     * @param operName 操作用户
     * @return 结果
     */
    public int resetStudentPassword(Long studentId, String operName);
}